home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 19 / Amiga Plus Leser CD 19.iso / Tools / Emulatoren / GameBoy / WarpVGB / VGBWOS.doc < prev    next >
Text File  |  1998-05-14  |  5KB  |  128 lines
  1.  
  2.  
  3.                    ******* Virtual GameBoy *******
  4.                 The Portable Nintendo GameBoy Emulator
  5.                              version 0.7
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                       email: fms@freeflight.com
  10.                             IRC:  RST38h
  11.                  WWW: http://www.freeflight.com/fms/
  12.  
  13.  
  14.                          * AMIGA VERSION *
  15.  
  16.                          by Lars Malmborg
  17.                       
  18.                       email: glue@df.lth.se
  19.                            IRC:  Glue
  20.                WWW: http://www.ludat.lth.se/~dat93lma/
  21.  
  22.          (*) GameBoy is a registered trademark of Nintendo.
  23.  
  24. PPC Version by MagicSN@Birdland.es.baewue.de (Joystick/Joypad support added
  25. since last version). lowlevel.library required. Parameter to activate it
  26. is joy ("vgb joy"). You can't use keyboard and joypad at the same time.
  27.  
  28. THIS EMULATOR IS SLOW ON AGA !!! USE IT ON A GFX BOARD !!!
  29.  
  30. What?
  31. -----
  32. o Amiga-ized application, i.e. uses Amiga argument parsing
  33. o Features of the Unix version are implemented
  34. o Requires OS 3.0
  35.  
  36. Why?
  37. ----
  38. Because the 0.3 version by Matthias Bethke & Michael Boese
  39. didn't work on my machine, so I had to make a new port.
  40. This port uses some of the Amiga specific code from that
  41. port, but I started off by porting the Unix 0.7, so it is more
  42. like a new port than an update of that port.
  43. The most important difference is that this port doesn't use
  44. the V40 'WriteChunkyPixels'. This will make the program run on
  45. more machines (f.ex. mine!)
  46. It has sucessfully been tested on the following machines:
  47. A1200/030 without graphics card.
  48. A3000/030 with CyberVision64 running CyberGraphX.
  49. A4000/040 without graphics card.
  50. A4000/040 with Picasso II running CyberGraphX.
  51.  
  52. How?
  53. ----
  54. This program uses the standard Amiga argument parsing.
  55. Enter 'AmigaVGB HELP' to show the options the program handles.
  56. Enter 'AmigaVGB ?' for options template.
  57. Options:
  58. Cartridge <program> - name of file to load as cartridge
  59. Verbose <level>     - Select debugging messages (default: 5)
  60.                         0 - Silent           1 - Startup messages
  61.                         2 - Illegal writes   4 - Illegal CPU ops
  62.                         8 - Bank switching
  63.                       Add numbers to activate multiple options!
  64. VPeriod <period>    - Set VBlank interrupts period (default: 10000ops)
  65. UPeriod <period>    - Number of interrupts per screen update (default: 2)
  66. Help                - Print this help page
  67. Cheat <GG code>     - Activate a GameGenie cheat
  68. Delay               - Delay line interrupts
  69. NoCRC               - Don't check cartridge CRC
  70. AutoA               - Autofire for button A
  71. AutoB               - Autofire for button B
  72. Trap <address>  (!) - Set address where to enter debug mode (default: $ffff)
  73. Colors <palette>    - Change all colors. The palette consists of four colors
  74.                       enumerated from bright to dark. A palette more like a real
  75.                       Gameboy is: 102010,104010,106010,00a000
  76. BColors <palette>   - Change background colors
  77. SColors <palette>   - Change sprite colors
  78. WColors <palette>   - Change window colors
  79. ScaleUp             - Double the size of the display
  80. PublicScreen <name> - Open windows on the named public screen
  81. Screen              - Open on a Screen (recommended for AGA)
  82. Nocgx               - Use WPA8 even on a GFX Board (not recommended at all)
  83.  
  84. (!) Trap is only valid if AmigaVGB is compiled with DEBUG defiend.
  85.  
  86. If no cartridge is given as an argument, an ASL file requester
  87. will pop up, where you can select one.
  88. The 'Interleave' argument is present in the Amiga version only. It will speed up
  89. the game by not rendering all the lines of the display. F.ex. setting it to 2
  90. will make the emulator only rendering every second line.
  91.  
  92. Some examples:
  93.  
  94. > AmigaVGB Cartridge demos/RPN.gb Colors 000000,004000,008000,00c000 AutoA
  95.  
  96. > AmigaVGB CR demos/SPACE.gb BC 808080,404040,202020,000000 SC 000040,000080,008000,004000 WC ffff80,ffc000,a0a020,504000
  97.  
  98. > AmigaVGB 2 CR Pacman.gb BC 000000,ffff00,000080,ff8000 SC 000000,ffff00,ff0000,0000ff WC ffff00,000000,ff0000,0000ff
  99.  
  100. While the emulation is running, the following keys are of interest:
  101.  
  102.   Help       - Pop up a window showing key bindings as below
  103.   Left Alt    or '+' on key pad   - 'A'
  104.   Left Shift  or '6' on key pad   - 'B'
  105.   Right Shift or '4' on key pad   - 'Select'
  106.   Return      or '5' on key pad   - 'Start'
  107.   Cursorkeys - Joypad
  108.  
  109.   ESC        - Quit emulation
  110.  
  111. If AmigaVGB is compiled with DEBUG defined, the following keys are also used:
  112.  
  113.   F1         - Go into built-in debugger
  114.   F2         - Show LCD controller registers
  115.   F3         - Show sprite registers
  116.  
  117. Kredz!
  118.  
  119. Marat Fayzullin                  - VGB
  120. Matthias Bethke & Michael Boese  - Amiga port of VGB 0.3
  121. Stefan Burström                  - Testing and LOTS of general help
  122. Stefan Zivkovic                  - Testing and hints
  123. John Carehag                     - Testing
  124. Simeon Everitt                   - Testing
  125. Steffen Haeuser                  - PPC Port
  126.  
  127. -Lars
  128.